---

Wired Movies and Sprites

| Previous | Chapter Contents | Chapter Top | Next |

Constant descriptions

kActionStatusString

Supported Flags: none Parm1: [CString statusString] Param2: [flags] You may use this action to instruct the QuickTime plug-in to display a URL link or other information in the status area of the browser. In order to do this, you set the flags parameter to kStatusStringIsURLLink and the statusString to a C string containing the URL or other information to display. QuickTime Streaming uses the status string action to report some types of streaming status. Your application may listen to this status by installing a movie controller filter procedure. In this case, the kStatusStringIsStreamingStatus bit will be set in the flags field. Additionally, if the kStatusHasErrorCode bit is set, then the high 16 bits of stringTypeFlags is an error code number.

enum {
    kStatusStringIsURLLink          = 1L << 1,
    kStatusStringIsStreamingStatus  = 1L << 2,
    kStatusHasErrorCode             = 1L << 3               
};

kActionAddChannelSubscription

(optional) Adds a channel guide subscription of kBookmarkSubscriptionType with the supplied title, URL, and, optionally, a picture URL to the QuickTime Preferences file.

kActionRemoveChannelSubscription

Supported Flags: none Param1: [CString URL] Removes the channel guide subscription of kBookmarkSubscriptionType from the QuickTime Preferences file if it exists.

kActionOpenCustomActionHandler

Supported Flags: none Param1: [ long handlerID ] Param2: [ComponentDescription desc] This action attempts to locate and open a custom action-handling component with the supplied component description and assign it the specified handlerID. If successful, the handler is kept open so that its state is retained between calls. It will be closed automatically when the movie is disposed.

This call may fail if there is no component of the specified type available, or if there is already a custom handler open with the same handlerID . You may use the kOperandUniqueCustomActionHandlerID to obtain a unique id for a handler you wish to open. You may use the kOperandCustomActionHandlerIDIsOpen to determine if a handler with a certain handlerID is open.

kActionApplicationNumberAndString

Supported Flags: none Param1: [long aNumber] Param2: [Str255 aString] This action does nothing. Applications may watch for this action and know that the first parameter is a number and second parameter a string. It could be used to communicate information from a movie to an application. To do this, your application needs to hook the movie controller's mcActionExecuteOneActionForQTEvent action and examine the atom container to determine if the current action is kActionApplicationNumberAndString , and if so, look at the parameter atoms. Another way to pass a string to an application would be to use kActionStatusString with a custom flag set. To do this, an application only needs to hook the movie controller's mcActionShowStatusString action.